GetMediaDataRefCount
TheGetMediaDataRefCount
function allows your application to determine the number of data references in a media.
pascal OSErr GetMediaDataRefCount (Media theMedia, short *count);
theMedia
- Specifies the media for this operation. Your application obtains this media identifier from such Movie Toolbox functions as
NewTrackMedia
andGetTrackMedia
(described on page 2-138 and page 2-190, respectively).count
- Contains a pointer to a field that is to receive the number of data references in the media.
DESCRIPTION
The count of references in a media corresponds to the maximum index value of any reference in the media. You can use this value to control a loop in which you retrieve all of a media's data references, using theGetMediaDataRef
function, which is described in the next section.ERROR CODES
invalidMedia -2008 This media is corrupted or invalid